home
***
CD-ROM
|
disk
|
FTP
|
other
***
search
/
Tech Arsenal 1
/
Tech Arsenal (Arsenal Computer).ISO
/
tek-20
/
caty16.zip
/
CATY161.DOC
< prev
next >
Wrap
Text File
|
1993-02-02
|
25KB
|
532 lines
CATY
Control program for Yaesu FT-767GX transceivers.
Version 1.6
Written in Turbo Pascal for PCDOS/MSDOS computers
by D. J. Wilke, N3HGQ.
Preliminary Documentation 12 January, 1992
OVERVIEW:
CATY is a program designed to take command of your Yaesu radio,
equipped with the CAT (Computer-Aided Tuning) system, from your
personal computer. This version was written to control the
FT-767GX. It will not work with the FT-747, 757, 980 or 1000.
The software exploits the full implementation of the CAT system,
allowing control of VFO/memory data entry, mode selection and
radio tuning. Complete status reporting from the radio is
displayed on screens which show all parameters grouped in a
logical, straightforward manner.
In addition to the memory channels designed into the radio, CATY
provides "Expanded Memory" for your Yaesu. 100 additional memory
channels per datafile can be copied to the internal VFO from
disk, allowing unlimited libraries of frequencies, modes, offsets
and identifying data to be archived. Once loaded from disk,
these additional channels reside in a memory array, and can be
scrolled and selected instantaneously.
Repeater offsets can be set automatically from the stored data,
eliminating the tedious procedure required to do the same task
using the radio's front panel.
An initial startup library of datafiles is provided for both
VFO and memory presets, containing known active communications
services such as international shortwave stations, amateur
repeaters, AMTOR, standard time signals, radioteletype, CW, FAX,
packet and standard broadcast stations.
All controllable parameters are entered from full-screen menus
and function keys, with the most often-used functions occupying
prominent positions. Between command sequences sent to the radio,
the software returns front panel control to the operator, permitting
manual operation to resume. An on-screen real-time clock displays
time in both local and UTC formats.
Large Frequency readout numerals equivalent to one-fifth the height
of the monitor screen are provided for the visually impaired. This
feature is also useful for monitoring the scanning function of the
program from a distance.
HARDWARE REQUIREMENTS:
IBM PC/XT/AT or compatible with at least 256k memory.
MDA/CGA/EGA/VGA display adapter and monitor.
RS-232 serial communications adapter configured as COM1: or COM2:.
Yaesu FT-767GX transceiver with CAT system.
Yaesu FIF-232C TTL to RS-232 interface or equivalent.
RS-232 interconnection cable (9 pin or 25 pin).
THE FILES:
The distribution disk contains the following ZIPped files:
PROGRAMS:
CATYnnn.EXE - The main executable program.
LOADYnnn.EXE - DOS quick memory loader.
SOURCE CODE:
CATYnnn.PAS - TP5 source for the main program.
CATY.GLO - TP5 global equates and setup parameters.
CATYGLO.PAS - TP5 unit source to access global references.
CATYDISP.PAS - TP5 unit source for screen display routines.
CATYCOMM.PAS - TP5 unit source for serial communications.
CATYTERM.PAS - TP5 unit source for TNC dumb terminal.
CATYNUM.PAS - TP5 unit source for large numeral readout.
CATYINST.PAS - TP5 unit source for radio instruction routines.
CATYMVFO.PAS - TP5 unit source for memory/VFO routines.
CATYUTIL.PAS - TP5 unit source for general utility routines.
CATYRTC.PAS - TP5 unit source for interrupt driven real-time clock.
UNIT FILES:
CATYGLO.TPU - TP5 compiled unit to access globals.
CATYDISP.TPU - TP5 compiled unit of screen routines.
CATYCOMM.TPU - TP5 compiled unit of comm routines.
CATYTERM.TPU - TP5 compiled unit of TNC dumb terminal.
CATYNUM.TPU - TP5 compiled Unit of large numeral routines.
CATYINST.TPU - TP5 compiled unit of radio command routines.
CATYMVFO.TPU - TP5 compiled unit of memory/VFO routines.
CATYUTIL.TPU - TP5 compiled unit of utility routines.
CATYRTC.TPU - TP5 compiled unit of real-time clock.
ASCII FILES:
CATYnnn.DOC - What you're reading now.
CATY1.BAT - Example config batch file for COM1:.
CATY2.BAT - Example config batch file for COM2:.
LOADY1.BAT - Batch file to quickload memories through COM1:.
LOADY2.BAT - Batch file to quickload memories through COM2:.
ASCII DATABASE FILES for VFO (capacity 100 entries per file):
Y7672MR.DAT - 2 meter FM voice repeater VFO database.
Y767BEA.DAT - 10 Meter CW BEACON frequencies VFO database.
Y767MCH.DAT - International MARINE radiotelephone VFO database.
Y767PAK.DAT - 2 Meter PACKET BBS VFO database.
Y767SWA.DAT - International shortwave 2.000 - 11.500 MHz
VFO database.
Y767SWB.DAT - International shortwave 11.500 - 28.000 MHz
VFO database.
Y767TTA.DAT - Commercial radioteletype 2.024 - 14.565 MHz
VFO database.
Y767TTB.DAT - Commercial radioteletype 14.500 - 19.280 MHz
VFO database.
Y767TTC.DAT - Commercial radioteletype 19.565 - 25.337 MHz
VFO database.
Y767UTC.DAT - International Shortwave by day of week & UTC time
VFO database.
ASCII DATABASE FILES for MEMORIES (capacity 10 entries per file):
Y76710M.MEM - 10 meter FM repeater memory datafile.
Y7672MR.MEM - 2 meter FM repeater memory datafile.
Y7676MR.MEM - 6 meter FM repeater memory datafile.
Y76770B.MEM - 70cM. (B) voice repeater memory datafile.
Y767AMB.MEM - AM broadcast band frequencies memory datafile.
Y767AMT.MEM - AMTOR/SITOR frequencies memory datafile.
Y767BEA.MEM - 10 meter CW BEACON frequencies memory datafile.
Y767DEF.MEM - DEFAULT/TIME signal setup memory datafile.
Y767FAX.MEM - WEFAX/WIREPHOTO frequencies memory datafile.
Y767PAK.MEM - HF/VHF packet frequencies memory datafile.
Y767RTY.MEM - RTTY/PRESS frequencies memory datafile
Y767SKD.MEM - "SKED" frequencies memory datafile.
Y767PM1.MEM - PMS scan, CW band: 10 thru 20 meters memory datafile.
Y767PM2.MEM - PMS scan, SSB band: 10 thru 20 meters memory datafile.
Y767WCB.MEM - W1AW CW bulletin frequencies memory datafile.
Y767WCP.MEM - W1AW code practice frequencies memory datafile.
Y767WPB.MEM - W1AW SSB & RTTY bulletin frequencies memory datafile.
note: When using the PMS memories; select memory 1, 3, 5, 7 or 9.
This corresponds to the low edge of the ADVANCED class CW
(PM1) or SSB (PM2) 10, 12, 15, 17 or 20 meter bands. Remem-
ber: load your memory file, set the squelch, press the radio's
PMS button, press the FAST button (selects the scan speed),
and then press the SCAN button. See page 27 in your Yaesu
Operating Manual for more information.
TEST FILES
UPDATE.DUM - Binary datafile for testing without comports.
INSTALLATION:
Configure your computer so that the serial RS-232 port(s) are
available as COM1: or COM2:. The Yaesu radio MUST have an
external RS-232 interface (FIF-232C) to connect to your computer
OR you must provide a way to communicate to/from the radio
using its provided TTL interface connector.
Only three communications lines are used: TX (Transmit Data),
RX (Receive Data) and Signal Ground, but pin 5 (CTS) and pin 6
(DSR) must be pulled high. This is taken care of by the FIF-232C
interface box and for this reason, it is suggested that at least
a 5-wire cable be provided. Pin-for-pin connections should exist
for pins 2, 3, 5, 6 and 7. If a three wire cable is used, pin 4
should be jumpered to pin 5, and pin 6 jumpered to pin 20 within
the female DB25 connector at the computer end. If your computer
is equipped with a 9-pin serial connector, a 9-to-25 pin RS-232
adapter will be required.
There is no hardware handshaking in the Yaesu CAT implementation,
so the interconnections are minimal.
FIVE WIRE CABLE:
TXD 2 ────────────────────────── 2
RXD 3 ────────────────────────── 3
COMPUTER CTS 5 ────────────────────────── 5 FIF-232C
DSR 6 ────────────────────────── 6
GND 7 ────────────────────────── 7
THREE WIRE CABLE:
TXD 2 ────────────────────────── 2
RXD 3 ────────────────────────── 3
RTS 4 ──┐
COMPUTER CTS 5 ──┘ FIF-232C
GND 7 ────────────────────────── 7
DSR 6 ──┐
DTR 20 ──┘
If COM1: is the choice, invoke the batch file CATY1.BAT; likewise
CATY2.BAT for COM2:. These files can be edited to inform the
local/UTC clock routines in CATY which time zone to use. The
default is EST. To change to another time zone, edit the second
command line option within the corresponding batch file,
for example:
<CATYnn [/comport] [/time zone]>
where [/comport] = [/1] or [/2] and
[/time zone] = [/EST] or one of the following:
[/EDT]
[/CST]
[/CDT]
[/MST]
[/MDT]
[/PST]
[/PDT]
Or invoke CATYnn.EXE with the corresponding command line options.
Be sure to issue the commands in the order shown - COM port first,
followed by the time zone. Separate each entry with a space from
the filename, using the forward slash character (/).
Your real-time or DOS clock, if set correctly, will display the
local time as well as the corresponding UTC time in the upper
right corner of the main menu. If your system does not have a
real-time clock/calendar card, edit CATY1.BAT or CATY2.BAT,
adding DOS DATE and TIME commands to set the correct local time
for CATY's RTC as in the following CATY2.BAT example:
echo off
CATYnn /2 /PST
date
time
If running from a floppy disk, be certain all supporting files
are present on the default drive. There will not be room for
all the source files (.PAS, .TPU) on a 360k disk. Prepare a
program disk containing at least the .MEM, .DAT, .EXE and .BAT
files. On hard disk systems, be sure to copy the complete set
of .MEM, .DAT, .EXE and .BAT files into a subdirectory named \CATY.
USING THE OPTIONS:
The program is entirely menu and function key driven. Upon
startup, you are presented with a full screen Main Menu and the
function keys on line 25. The available options are:
KEY WHAT IT DOES
=== =============================================================
<Spacebar> Displays complete radio status as a full screen display
<1> Queries operator and sets operating frequency of VFO<A>
also shows CW & PHONE band limits for ADVANCED CLASS operation
<2> Queries operator and sets programmed frequency step,
also allows frequency scanning in either direction
<3> Selects between VFO<A>, VFO<B> or Memory
<4> Selects active memory channel, 0 through 9
<5> Sets operating mode to LSB, USB, CW, AM, FM or FSK
<6> Sets CTCSS tone frequencies
<7> Loads all ten memories from specified Y767xxxx.MEM disk datafile
(allows scanning from the radio's scan button only)
<8> Loads VFO<A> from specified Y767xxxx.DAT disk datafile
(allows scanning from the keyboard, forward or backward
through the file!)
<9> Sets up VFO<A> and VFO<B> for split frequency repeater operation
<0> Selects the Packet communications screen (TNC)
<+> Steps UP 10 Hertz in frequency, displays result
<-> Steps DN 10 Hertz in frequency, displays result
<F1> Selects between HAM bands and GENeral coverage
<F2> Turns off SPLIT, CLARifier, OFFSET functions (Reset)
<F3> Moves down to next lower band (depends on HAM/GENeral setting)
<F4> Moves up to next higher band (depends on HAM/GENeral setting)
<F5> Toggles SPLIT on or off
<F6> Toggles CLARifier on or off
<F7> Moves parameters from selected memory to VFO<A>
<F8> Moves parameters from VFO<A> to selected memory channel
<F9> SWAPs parameters of VFO<A> with selected memory channel
<F10> Quits the program and returns to DOS
KEYSTROKE ENTRY:
You may want to experiment with "multiple" keystroke entries.
i.e. from the MAIN MENU to enter a frequency of 147.150 and set it
up for 2 meter repeater operation you do not have to wait for, or
follow all the instructions on the different screens. You can enter
from the MAIN MENU (leave out the commas) 1, 147.150, <enter>, F, F5.
Your `767 will then be set on 147.150 (VFO A), 147.750 (VFO B) in
the FM mode with the SPLIT on.
REPEATER OPERATION:
Choosing <9> from the main menu presents you with a screenful
of the values retained in the Yaesu's memories. If, for example
the ten memories were loaded from the file Y7672MR.MEM, the output
frequencies of the repeaters contained in that file are displayed,
and the radio at this point is in simplex operation. When a
selection is made from the menu, the repeater output frequency
from the file is compared to the appropriate internal band plan
table. The proper offset frequency is automatically sent to
VFO<B>, and the radio is then set up for SPLIT frequency operation.
The screen which follows displays the frequencies of both VFOs,
as well as the program's internal band plan. VFO<A> will be set
to the frequency on which the repeater can be heard (output),
and VFO<B> is tuned to the frequency on which the radio will
transmit (input). There are entries for the popular repeater
bands from 6M up through 70cM, depending, of course upon whether
the corresponding plug-in module is installed in the radio.
SCANNING:
Two scanning schemes are implemented: frequency scan and datafile
scan. Frequency scan permits scanning up or down from the currently
selected frequency by an increment (Step Frequency) arbitrarily
chosen from Menu selection <2>. This is very handy for browsing
the SWL bands. For example: Choose <1><CR> "Set Operating Frequency"
from the the Main Menu, enter 9.5 <CR> in the Frequency box, enter
"A" <CR> (AM) in the Mode box; the Main Menu again reappears. Pick
<2><CR> "Set Programmed Tuning Step/Scan", enter 5 <CR> (kHz.) in
the Step Frequency box, then <Cursor Right>. The scan starts at
9.5000 mHz. and increments by 5 kHz. at the rate of approximately
one step each second. To stop the scan at any desired frequency,
just tap the <Spacebar>. The scan can be resumed in either direction
by using the cursor keys. The lower third of the Programmed Step
screen displays the frequency in large numerals which can be seen
from across the room. Actually, this feature was designed for the
visually impaired, as the operating frequency is much more easily
set and read from the keyboard than from the radio's front panel.
Datafile Scan is accessed from Function Key <F2>. A screenfull
of data are presented, allowing choices by either scrolling through
the 100 entries line-by-line, page-by-page or initiating a scan
in either the forward or reverse direction through the selected
file. As in the Frequency Scan, the process can be stopped at any
time by tapping the <Spacebar>.
QUICK MEMORY LOAD:
There is a convenient way to quickly load or change all ten memory
frequencies from DOS. The datafiles ending with .MEM can be loaded
into the Yaesu's memories using a separate file named LOADYnn.EXE.
Two batch files are included for this utility which allows the use of
your choice of COM port. It is only necessary to indicate the
three letter category of the desired service on the command line
following the LOADYn.BAT invocation, as in:
LOADY1(or LOADY2) PAK<CR>
- Loads 10 popular packet frequencies from Y767PAK.MEM
LOADY1(or LOADY2) FAX<CR>
- Loads 10 WEFAX facsimile frequencies from Y767FAX.MEM
or
You can invoke LOADYnn.EXE directly, providing your own command
line option such as:
LOADYnn PAK /1<CR> - Loads Y767PAK.MEM through COM1:
LOADYnn PAK /2<CR> - Loads Y767PAK.MEM through COM2:
The default COM port is COM1: if no command line argument is
supplied.
For simplicity, the command to LOADY is shortened to the three
characters preceding the .MEM filetype, characterizing the type
of service the memory datafiles represent. For example:
10M = 10 meter FM repeater frequencies.
2MR = 2 meter FM repeater frequencies.
6MR = 6 meter FM repeater frequencies.
70B = 70cM (B) band repeater frequencies.
AMB = AM broadcast band frequencies.
AMT = AMTOR/SITOR frequencies.
BEA = 10 meter CW BEACON frequencies.
DEF = DEFAULT/TIME signal frequencies.
FAX = WEFAX/WIREPHOTO frequencies.
PAK = HF/VHF packet frequencies.
RTY = RTTY/PRESS frequencies.
SKD = "SKED" frequencies.
PM1 = PMS scan, CW band: 10 thru 20 meter frequencies.
PM2 = PMS scan, SSB band: 10 thru 20 meter frequencies.
WCB = W1AW CW bulletin frequencies.
WCP = W1AW code practice frequencies.
WPB = W1AW SSB & RTTY bulletin frequencies.
As in:
DEFFAULT.MEM = LOADYnn DEF<CR> or LOADYnn DEF [/1] [/2]<CR>
New MEMORY files can be created using your favorite ASCII editor,
just be sure to follow the header and line structure of the
included .MEM files and don't exceed 10 entries. This file
naming convention must be followed for LOADYnn.EXE to work.
PACKET OPERATION:
Selecting <0> from the Main Menu takes you to the Packet (TNC)
communications screen. CATY will control your TNC through a
split screen dumb terminal which displays incoming data at the
top portion of the screen, and transmitted data on the lower
portion. Seven of the more commonly used functions are provided
for the AEA PK-232 TNC:
KEY MNEMONIC WHAT IT DOES
========== ======== ====================================
<F1> Help = H Displays brief PK-232 help screen
<F2> Disp = DISP Show PK-232 parameters/classes
<F3> Monit = M Set monitor to mode 6 (show all)
<F4> RTTY = BA,RB,WI Start Baudot RTTY mode @ 45 baud
<F5> Heard = MH Display call signs heard
<F6> H Pak = PA,V,HB Start HF Packet mode @ 300 baud
<F7> V Pak = PA,V,HB Start VHF Packet mode @ 1200 baud
<F8> Disc = D Send DISC to distant station
<F9> ARQ = AL Start AMTOR ARQ "Listen" mode
<F10> Stat = CS Show status of channels (links)
<Page Up> = CONV Start Converse mode from command
<Page Down> = COM Character escape to CMD: mode
<Home> = Clear receive screen of clutter
<End> = Quit to Main Menu
But any TNC function may be executed by typing the command while
in the CMD: mode. The program as coded is set up for 1200 baud
communications, 8 bit word, no parity through the TNC port.
RELEASE NOTES:
CATY is no cost software. You cannot be charged a fee
to obtain a copy of this software including documentation
and database files. You may use the program and tinker with
the source code, but you may not sell this code or program.
You may give a copy of this software to any person who desires
it as long as there is no charge for obtaining the copy.
This software is being made available as a learning and
development vehicle for the amateur radio community.
These programs are NOT in the public domain.
Some bugs fixed from earlier versions:
CTCSS tone module is now operational
Timing adjusted for faster CPUs (tested on 33 mHz 486)
Split toggle now works full-time
420-450 MHz offset operation is now correct
Error trapping is now somewhat kinder
New enhancements include:
10 meter repeater operation with auto setup
Time zone support for all of CONUS from command line
Redesigned menu interface
Improved repeater offset handling
VFO datafile frequency scanning, both directions
LARGE on-screen frequency display for scan operation
Frequency scanning using selected step frequency
TNC control with split screen packet terminal
This .DOC file requires a great deal more work as the source
code evolves. The program was developed entirely in Turbo Pascal
Version 5.5, utilizing Unit files. Future planned enhancements
may include:
Support for FT-747, FT-757, FT-980, FT-1000
An automatic logging module
Integrated datafile creation
Custom setups from .CFG files
PTT control from keyboard (requires hardware mod)
COM3: and COM4: operation
Lookup tables for packet commands
Linkage to existing BBS programs
A DOS shell function
...and ideas from contributors.
CAMARADERIE:
There has been much interest from `747, `757 `980 and `1000
owners who have tried to use the program. Of course, they were
disappointed when the radio produced only garbage on the
computer screen, especially after being tantalized by the
program's display menus. "It almost works", they all say.
Unfortunately, there is no correlation between the different
model radios. Yaesu changed the command tables with each;
some use handshaking, some don't.
Well, re-coding all the command tables and serial handshaking
routines is not a trivial job. I have collected all of the
command instruction sets for the various Yaesu radios known
to man. I'm in the process of tabulating the command codes,
memory configurations, unique functions and handshaking, with
plans of producing (hopefully) a universal CATY source, which
could be customized from the program's command line for the
different CAT-equipped rigs.
Of course I don't have access to all these radios, so testing
will have to be done elsewhere. Any ideas or caveats you may
have on this topic would be greatly welcomed.
Response from FT-767 users has been very encouraging. Thanks
to all who have auditioned this program and submitted ideas and
suggestions for improvements. Some of those ideas have been
incorporated in this current version. For these, I am very
grateful. What is needed most is feedback from knowledgeable
users. All inputs, recommendations, critiques, wish lists and
bug reports are requested. The program begs for critique from
diverse disciplines and perspectives.
Please keep the ZIPed package intact with all datafiles,
source code and documentation. When updating the source,
please maintain the naming convention (e.g. CATY15.ZIP,
CATY151.ZIP, etc.) You may help with the cause by sending me
code snippets which you believe would augment the program.
The program belongs to the ham community, so any improvements
provided by you will be shared by all.
My main mentor during the development of this project was
Jeff Duntemann. His unique conversational style was mainly
responsible for any absorption of the Pascal language which
produced these programs. I highly recommend his book "Complete
Turbo Pascal, Third Edition." In my opinion, it is the best
text available on the subject.
Larry Laffoon, N3CAM is responsible for the addition of the
much expanded memory and datafile screens as well as the PMS
scanning routines and the CTCSS universal tone number
designators.
This project represents many hours of work, and continues to
be a very valuable learning experience. My hope is that it
will serve as a springboard for a really solid and useful ham
radio program.
How about it guys and gals - will you help sweeten the code?
73, Don Wilke
N3HGQ @ K3PZN.MD.USA.NOAM
4228 Mount Carmel Road
Upperco, MD 21155